HyperBibTeX is a HyperCard stack for managing bibliographic databases compatible with BibTeX, the bibliography system used by the TeX typesetting language. HyperBibTeX's features include:
* entering and editing bibliographic entries using BibTeX's entry types
(Book, Article, Proceedings, etc.),
* checking data integrity and consistency against a set of authority lists,
* sorting on various fields,
* searching the database,
* marking cards individually or with the search function,
* importing entries from a BibTeX file,
* exporting cards to a BibTeX file.
System Requirements
HyperBibTeX requires HyperCard version 2. It will run under version 2.0, but version 2.1 is recommended because of its improved error handling. It will also run under HyperCard Player. HyperBibTeX should run fine under system 6, but the Balloon Help facility requires system 7.
Installation
HyperBibTeX stacks use two auxiliary stacks: HyperBibTeX Utils and HyperBibTeX Help. These stacks either should be in the same folder as the main bibliography stack or you should set up the Search Paths in your Home stack so that Hypercard can find them. There should be only one copy of each of these stacks on your system.
Getting Started
To get started, open the sample stack "SIL Computing Bibliography" and browse around. For help, turn on Balloon Help (on the ? menu under system 7) or go to the HyperBibTeX Help stack by choosing Help on the Go menu. Then create your own stack by copying "HyperBibTeX 0.9.7 blank stack"; either enter new entries by hand or import an existing .BIB file.
Version History
Version 0.9.5d ---> version 0.9.5f changes:
• fixed menu bug affecting HC 2.0
• fixed balloon help bug affecting system 6
• added dialog asking to back up stack
Version 0.9.5f ---> version 0.9.6 changes:
• fixed bug in Export command that dropped certain non-BibTeX fields
• fixed bug in Import command that didn't properly import some user-defined fields
• added option to choose either quotes or braces as default field delimiters
• added index window which shows a list of keys of selected cards; clicking on a key sends you to that card
• improved error handling (especially with HyperCard 2.1)
• numerous minor bug fixes and improvements
Version 0.9.6 ---> version 0.9.7 changes:
• tried to fix sorting problem with non-English versions of HyperCard
• fixed incompatibility problem with HyperCard Player
Upgrading to a new version of HyperBibTeX
If you have a bibliography stack created with version 0.9.5d (or e or f) you should upgrade it to version 0.9.7. Do the following:
IMPORTANT: If you are using HyperBibTeX version 0.9.5 (that is, 0.9.5d, 0.9.5e, or 0.9.5f) you must first fix a bug in the Export command (it drops certain non-BibTeX fields, namely ISBN, Location, and Annote). The current release of HyperBibTeX (version 0.9.7 or higher) includes a special stack called “Patch HyperBibTeX 0.9.5”which patches the stack “HyperBibTeX Utils”. Open the patching stack and follow the instructions. If you don't do this you may lose data !
1. After patching the Utils stack, open your bibliography stack (say, MyBiblioStack) and go to the Preferences card (choose "Preferences" on the Utilities menu).
2. Ensure that the option "Expand abbreviations" is *NOT* checked. Choose either quotes or braces as field delimiters.
3. Type a file name into the box "BibTeX file name" (optional).
4. Leave the Preferences card (return to the main part of the stack).
5. Choose "Export..." on the Utilities menu.
5a. Sort the stack if desired, otherwise click "Skip".
5b. Select ALL cards.
5c. Select ALL non-BibTeX fields.
5d. Select a file name and click "Save".
6. Close the stack (MyBiblioStack).
7. Make a copy of "HyperBibTeX 0.9.7 blank stack", rename it (MyNewBiblioStack), and open it.
8. Ensure that any user-defined fields you have used in the .BIB file are declared in the box "User-defined field names".
9. Choose "Import..." on the Utilities menu and select the .BIB file you just exported.
10. If you are asked "Import abbreviation strings?", click "No".
11. When the importing is finished, all that remains is rebuild the authority lists. To do this, open the old stack in a new window and copy and paste each authority list from the old stack to the new stack (there are four lists). (Alternatively, use the Verify Field command to rebuild the lists.)
12. Be sure to delete the old versions of the stacks "HyperBibTeX Utils" and "HyperBibTeX Help" and install the new versions. There should be only one copy of each of these stacks on your system.
Please report any problems or suggested enhancements to me.
